package com.newshub.business.service;

import com.newshub.business.entity.Users;
import com.newshub.business.dto.UserQueryDTO;
import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * 用户服务接口
 */
public interface UsersService {
    
    /**
     * 根据ID获取用户
     */
    Users getById(Integer id);
    
    /**
     * 根据用户名获取用户
     */
    Users getByUsername(String username);
    
    /**
     * 根据邮箱获取用户
     */
    Users getByEmail(String email);
    
    /**
     * 获取所有用户
     */
    List<Users> getAll();
    
    /**
     * 创建用户
     */
    boolean create(Users user);
    
    /**
     * 更新用户信息
     */
    boolean update(Users user);
    
    /**
     * 删除用户
     */
    boolean delete(Integer id);
    
    /**
     * 更新登录信息
     */
    boolean updateLoginInfo(Integer id, LocalDateTime lastLoginTime);
    
    /**
     * 检查用户名是否存在
     */
    boolean existsByUsername(String username);
    
    /**
     * 检查邮箱是否存在
     */
    boolean existsByEmail(String email);
    
    /**
     * 分页查询用户
     */
    List<Users> getUsersByPage(UserQueryDTO queryDTO, int offset, int limit);
    
    /**
     * 统计分页查询的总数
     */
    long countUsersByPage(UserQueryDTO queryDTO);
    
    /**
     * 更新用户状态
     */
    boolean updateStatus(Integer id, Integer status);
    
    /**
     * 批量删除用户
     */
    boolean deleteBatchUsers(List<Integer> ids);
    
    /**
     * 批量更新用户状态
     */
    boolean updateBatchStatus(List<Integer> ids, Integer status);
    
    /**
     * 获取用户统计信息
     */
    Map<String, Object> getUserStats();
}



